home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / prog / manage2.zip / MANAGER.DOC < prev    next >
Text File  |  1990-02-21  |  38KB  |  729 lines

  1.                            NOTES ON MANAGER.COM 2.68
  2.  
  3.                                  Matt Roberts
  4.                                5 Cedar St., # 8
  5.                            Montpelier, Vt 05602-3006
  6.                                  (802)223-2553
  7.  
  8.                                    5-11-92
  9.  
  10. ───────────────────────────────────────────────────────────────────────────────
  11.                                GENERAL OVERVIEW
  12.  
  13. The idea of The Manager is to provide a program which can access the 
  14. computer's capabilities in a menu-oriented, user-friendly environment.  Where 
  15. possible, I've tried to use plain English for both the options and the error 
  16. messages.  This is a life-long project, and I hope to add options which access 
  17. such things as expanded memory, graphics capabilities, peripherals, and what-
  18. not.  For right now, though, I'm just trying to get the silly thing so it can 
  19. do everything COMMAND.COM can do, from a menu interface.
  20.                                      
  21.                                      BUGS
  22.  
  23. This section is reserved for bugs in the program.  One thing that's nagging me 
  24. at the moment is in the File-listing utility; subdirectories aren't labelled 
  25. as such.  As a result, any file you see in the list could theoretically be 
  26. either a user file or a directory.  I've tried everything I could think of, to 
  27. no avail.  Looking at the document, I've reached to the conclusion that I'll 
  28. be able to solve the problem when and if I learn how to access machine code 
  29. from ASIC.  Unfortunately, this isn't likely to happen for quite a while.  
  30. Since I need to fix this to use other parts of the program more effectively, 
  31. however, I'll be puzzling over it and I'll try to solve that problem as soon 
  32. as I can. 
  33.  
  34. Another problem seems to be in the "Run Other Programs" routine.  Please see 
  35. that section for a full descriptions but, in short, some programs won't run 
  36. properly with that feature.  I'm going to try to fix it, but I'm not certain 
  37. it's something I can do anything about.  We'll find out soon enough, though.
  38.  
  39. I'm currently trying to figure out a way to copy/move executable, overlay, and 
  40. other files besides those that are purely text.  Since I can't seem to figure 
  41. out how to do that with ASIC, I'll be looking at other languages soon; if I 
  42. can figure out how to do it with one of the languages I have, I'll make it a 
  43. module I can call from ASIC.  Until I get something worked out, you can only 
  44. copy text files from The Manager.
  45.  
  46. Because of the way I "organize" my work, some of the capabilities of this 
  47. version may not yet be documented.  I try to write them in so they're not too 
  48. difficult to understand, so you should be able to use them even if they're not 
  49. in here.  If that's not so, give me a call and I'll help you through as best I 
  50. can. 
  51.  
  52. Finally, not all the error-handling routines may have been written.  As a 
  53. result, you may be informed that the action has been carried out, even if it 
  54. hasn't.  If you ask The Manager to remove a directory, and that directory is 
  55. not empty (for instance), The Manager will return an error to the program.  If 
  56. there's nothing to deal with that error, it will go on to the next step, which 
  57. is to tell you that the directory has been removed, even though a directory 
  58. can't be removed if it has anything in it.  This will be corrected in the 
  59. future, but for now you're temporarily on your own as to checking for 
  60. correctly spelled pathnames, etc.  You might want to try creating errors in 
  61. 2
  62. certain options that don't always work quite right, to see if the error 
  63. routines have been plugged in yet.  In general, the error routines are there 
  64. and functioning; some options may not have had that part completed yet, 
  65. though.  I apologize for the hassle, and thank you for your patience. 
  66.  
  67.                          
  68.                          SYSTEM REQUIREMENTS AND NOTES
  69.  
  70. The Manager was written using ASIC 3.01 by David Visti.  I find it excellent 
  71. for most purposes, and recommend it highly.  The author can be reached at P.O. 
  72. Box 2952, Raleigh, NC 27602-2952.  Registration is only $10.00, and I sent in 
  73. mine before the guy comes to his senses and starts charging what it's worth. 
  74.  
  75. The computer used was an Amstrad PC1512 SD.  This system has an 8086 
  76. processor, running at 8MHz (non-switchable).  It has 640K RAM, and 2Mb EMS.  
  77. The monitor/display card is a black and white composite monochrome/CGA.  It 
  78. has two 5.25", 360K floppy drives, and a 49Mb hard drive card.  1Mb of EMS has 
  79. been used to create an EMS disk (same as a RAM disk, but uses EMS).  The 
  80. Amstrad PC1512 has been discontinued.
  81.  
  82. You'll need approximately 195K of RAM to run The Manager.  The file-listing 
  83. utility (SEEFILES.COM) is in a separate file because it was the only way I 
  84. could fix a bug.  When it was part of the main program, shelling to DOS would 
  85. result in the file-listing utility being somehow corrupted.  I tried 
  86. everything I could think of, and finally decided that maybe if it was called 
  87. from DOS itself, the DOS shell wouldn't bother it.  Worked out fine, though I 
  88. don't know why (I make a lot of lucky guesses).  Here's a rundown of the files 
  89. (as of this writing), what they do, and how important they are: 
  90.  
  91. CRAPPYED.ASI- The ASIC source code for CRAPPYED.COM.  Not necessary, but 
  92. useful to programmers.
  93.  
  94. CRAPPYED.COM- "CRAPPY text EDitor".  Doesn't work right, so it isn't called 
  95. from The Manager yet.  Not necessary.
  96.  
  97. INSTALL.CFG - Installs an automatic DOS parameter.  Necessary because ASIC 
  98. opens it first thing, even if nothing has been installed.  It isn't necessary 
  99. for anything to have been installed, just that the file exists.
  100.  
  101. MANAGER.ASI- The ASIC source code for MANAGER.COM.  Not necessary, but useful 
  102. if you want to see how The Manager was put together.
  103.  
  104. MANAGER.COM - The main program.  Necessary because all the other files are 
  105. controlled from this one.
  106.  
  107. MANAGER.DOC- The documentation for The Manager.  The file you're reading right 
  108. now.
  109.  
  110. MANAGR40.ASI- The ASIC source code for MANAGR40.COM.  Not necessary, but 
  111. useful to programmers.
  112.  
  113. MANAGR40.COM - Runs in 40-column width; probably most helpful to the visually 
  114. impaired.  This is necessary if you want to run The Manager in large print, 
  115. otherwise not.
  116.  
  117. NUMLOCKF.BAS- The ApBASIC source code for NUMLOCKF.EXE.  Not necessary, but 
  118. useful to programmers.
  119.  
  120. NUMLOCKF.EXE- Utility to turn the Num Lock key off.  If you want to turn the 
  121. Num Lock key off yourself when you're using the Crapulator (explained further 
  122. 3
  123. in this documentation), you won't need this.  If you want it turned off 
  124. automatically, you'll need it.
  125.  
  126. NUMLOCKN.BAS- The ApBASIC source code for NUMLOCKN.EXE.  Not necessary, but 
  127. useful to programmers.
  128.  
  129. NUMLOCKN.EXE- Utility to turn the Num Lock key on.  If you want to turn the 
  130. Num Lock key on yourself when you're using the Crapulator (explained further 
  131. in this documentation), you won't need this.  If you want it turned on 
  132. automatically, you'll need it.
  133.  
  134. PRINTERU.ASI- The ASIC source code for PRINTERU.COM.  Not necessary, but may 
  135. be of some interest to programmers.
  136.  
  137. PRINTERU.COM- An unfinished PRINTER Utility.  All it has right now is menus, 
  138. which just go to other menus.  It isn't called by The Manager, and is not 
  139. necessary.
  140.  
  141. SEEFILES.COM - The file finding option.
  142.  
  143. UTIL1-40.ASI- The ASIC source code for UTIL1-40.COM.  Not necessary, but 
  144. useful to programmers.
  145.  
  146. UTIL1-40.COM- Utilities called by MANAGR40.COM.  Necessary if you want to use 
  147. 40-column mode, otherwise not.
  148.  
  149. UTIL1-80.ASI- The ASIC source code for UTIL1-80.COM.  Not necessary, but 
  150. useful to programmers.
  151.  
  152. UTIL1-80.COM - Utilities called by MANAGER.COM.  Necessary, since a lot of 
  153. options are contained in this file.
  154.  
  155.  
  156. Anything in the above list that's not necessary can be deleted to make more 
  157. room on your disk if you like.  However, I'd appreciate it if you'd distribute 
  158. all the files when you pass it around.  If you want to send it ZIPped, I'd 
  159. prefer that it be called MANAGR.ZIP or MANAG263.ZIP.  Thanks.
  160.  
  161.  
  162. The Manager is primarily a mental exercise, although my ultimate goal is to 
  163. offer a program that can do just about everything you can do from DOS.  At the 
  164. moment, there are serious limitations, but there are also a few options that 
  165. are awfully handy to have, some of which aren't available from the DOS prompt 
  166. (as far as I know), and some which do the job in a friendlier or (once in a 
  167. great while) better way.  So, there's some solid value here, in my opinion.  
  168. If you agree, you're invited to send a $5.00 donation.  If you disagree, 
  169. you're still invited, although I suppose you won't be much inclined to accept 
  170. (sigh). 
  171.  
  172. The Manager doesn't have a very comprehensive selection of features at 
  173. present.  Since ASIC 2.00 and above has the ability to access machine 
  174. interrupts, more features can probably be developed, but I don't know how to 
  175. write machine code.  As a result, you may find this program a bit 
  176. disappointing.  However, it does have some uses, and certainly serves as a 
  177. demonstration of how to program with ASIC, since the source code is included. 
  178.  
  179. For some reason, I've become addicted to file managers.  I've already written 
  180. one for Locomotive BASIC 2 version 1.16, and I'm currently working on one for 
  181. GW-BASIC 3.22.  I'll also be writing a file manager for ApBASIC 1.7 at some 
  182. point in the near future, and possibly one using Powerbatch, a standard batch 
  183. 4
  184. file, and a compiled batch file.  Maybe one of the reasons I like writing file 
  185. managers is the amount I learn about the language, its capabilities and its 
  186. limitations.  Anyway, I may be offering others soon.
  187.  
  188. If you're having trouble using any of the programs on the disk, and the 
  189. documentation doesn't seem to help, you can call me between 9AM and 9PM EST, 
  190. and I'll do what I can to help.  I'm in and out during the day, so keep 
  191. trying.
  192.  
  193. In the program menu, you'll see selections that might look something like 
  194. this:
  195.  
  196. Alt-Fn- Selection.
  197.  
  198. To get that selection, you'll hold down the Alt key and, while still holding 
  199. the Alt key down, press the function key (or other key) indicated by Fn.  So, 
  200. if you see
  201.  
  202. Alt-F1- Do Your Laundry.
  203.  
  204. hold down the Alt key, and press the F1 key without letting go of Alt, and the 
  205. computer will do your laundry.  You may see another menu, from which you would 
  206. choose from such options as bleach, fabric softener, and the like.  Maybe my 
  207. friends are right; maybe I should get that brain scan after all.
  208.  
  209.  
  210.                                USING THE PROGRAM
  211.  
  212. You start by putting your disk in the drive and typing MANAGER at the DOS 
  213. prompt.  After a bit of foolishness, you get to the main options menu, which 
  214. invites you to delete files, make a directory, rename files, read today's date 
  215. and/or time, shell to DOS, blank your screen, quit, and a bunch of other neat 
  216. stuff you can't possibly live without.  You press the function key 
  217. corresponding to your choice, or the Esc key to return to DOS, and you're on 
  218. your way.  Isn't this exciting?  OK, so I'm easily amused. 
  219.  
  220. The bit of foolishness I mentioned is the opening screen, which blabbers a bit 
  221. about me and begs for money.  Very soon now, I'll be adding an option to 
  222. bypass the screen and go directly to the options menu.  The only reason I 
  223. didn't include it when I was writing the other install options is because I 
  224. forgot.  I found out how annoying that silly thing is when I was testing the 
  225. code; sometimes I'm just not in the mood.  Versions 2.65 and above should give 
  226. you the chance to avoid that particular bit of annoyance.
  227.  
  228.  
  229.                               LISTING DISK FILES
  230.  
  231. Operation is fairly simple; you just type in the directory in which you want 
  232. to view the files, giving the full DOS path.  The concept of a path is fairly 
  233. simple, and will be in your DOS manual.  If you don't get it the first time, 
  234. don't think you're a dummy; DOS manuals are written by Martians because the 
  235. labor is cheap.  Unfortunately, the little green guys haven't quite mastered 
  236. the art of English yet, and tend to make simple explanations a bit 
  237. complicated.  If you just can't figure out what a path is, give me a call and 
  238. I'll see what I can do to help.  Please have your DOS manual ready, and have 
  239. your telephone as near to the computer as possible, since it'll help if I can 
  240. run you through some simple exercises which involve making directories and 
  241. changing to them.  I'd appreciate it, though, if you'd give the DOS manual a 
  242. try first, and maybe your computer's technical support line second.  Thanks.
  243.  
  244. 5
  245. Anyway, once you've typed in the path and directory, you'll be treated to a 
  246. list of files.  This list will include directories, but I haven't figured out 
  247. a way to label them as such when they're printed on the screen.  I'm working 
  248. on it, though.  At the end of the list, you'll be invited to list some more 
  249. files; if you respond positively, you'll get to type in your path/directory 
  250. again.  Otherwise, you'll go back to the menu.
  251.  
  252. One important note: if you want to view the root directory of a drive, don't 
  253. type the backslash (\).  For instance, to view the files in the root directory 
  254. of drive A, you would type A: as your directory.  The backslash will be 
  255. supplied by The Manager.
  256.  
  257.  
  258.                                 READING A FILE
  259.  
  260. This feature allows you to read a file on your screen.  It's very primitive, 
  261. and is essentially an extension of the DOS command TYPE and the DOS command 
  262. MORE.  The text file scrolls past your screen.  It'll stop at each screenful, 
  263. and invite you to press a key to continue.  You can also stop the scrolling by 
  264. pressing the space bar.
  265.  
  266.                                 PRINTING A FILE
  267.  
  268. This one is like the file-reading routine, except you're printing (surprise).  
  269. You press the space bar to pause printing.  There will still be data in the 
  270. printer's buffer, and I don't know a way to flush that without losing the 
  271. place in the file, so you'll have to take the system off-line if you need to 
  272. stop in a hurry.  If you're not in a rush, though, it'll stop printing when 
  273. the data in its buffer is printed.  Press any key to continue printing.  When 
  274. you press the space bar to pause, there will probably be a few seconds delay 
  275. before it can process the keypress.  That's because it processes the text file 
  276. one line at a time, and it can't get to processing your keypress until it's 
  277. finished with the line it's working on.  It won't increase the amount printed, 
  278. except by that one line.  Don't press the space bar again, because The Manager 
  279. will process both keypresses, in order, and will assume you want to continue 
  280. printing. 
  281.  
  282. You can quit printing by pressing the Esc key.  Again, it will probably take a 
  283. second or two for The Manager to finish with the line it was working at the 
  284. time, and get to your keypress.  The amount printed will only be increased by 
  285. that one line, and you'll be sent back to the menu shortly.  If you press Esc 
  286. twice, The Manager will process both Esc key presses, first sending you back 
  287. to the menu, and then sending you back to DOS.
  288.  
  289.  
  290.                               COPYING TEXT FILES
  291.  
  292.  
  293. At this point, you can't copy any type of file except a text (ASCII) file.  
  294. I'm working on an option to copy any type of file but, for now, only a text 
  295. file will copy properly.  Anything else won't work.
  296.  
  297. You type in the path and filename of the file you want to copy, and then the 
  298. path and filename for the destination.  The copy procedure is slower than with 
  299. DOS, but it doesn't take too long.  The date and time of the copy is changed 
  300. to match that of your system clock.
  301.  
  302.  
  303.                                MOVING TEXT FILES
  304.  
  305. 6
  306. Again, you can't move non-text files with this option.  It's dangerous, 
  307. because the original is deleted after the copy is made.  Until you are certain 
  308. a specific type of file will copy the way you want it to, please use test 
  309. files and backups.  Otherwise, you could lose important data.
  310.  
  311.  
  312.                                 RENAMING FILES
  313.  
  314. Have I mentioned that it's a good idea to make backups of all your files?  
  315. Here's another good reason.  Certain file extensions cannot be changed without 
  316. rendering them useless for their original purposes.  Files with an extension 
  317. of .BAT, .COM, .EXE, and other files shouldn't be messed with, unless you know 
  318. what you're doing.  Also, some programs use overlay files, and will not run if 
  319. they can't find what they're looking for.  Others read and write files with 
  320. specific extensions, and won't load them if they've been changed.
  321.  
  322. On the other hand, you can do almost anything you want (assuming it's legal, 
  323. moral, and physically possible) with a backup file.  The original is safe and 
  324. sound, and can replace the object of your experiments if things don't work out 
  325. as planned.  In fact, you might want some extra security by making a copy of 
  326. the copy, and keeping each "version" in a different location.  That way, 
  327. whatever befalls one won't be as likely to befall the others.
  328.  
  329. But I digress (constantly).  You'll first tell The Manager the name of the 
  330. file you want to change, including drive and path.  When prompted, you type in 
  331. the new name for the old file (if you write down both the old and new 
  332. filenames at this point, you can change them back if needful).  The Manager 
  333. does the dirty deed, and offers more of the same kind of fun. 
  334.  
  335. You can't change a name across drives.  For instance, you can't change 
  336. A:\TEST.DOC to B:\TEST.DOC.  Also, you'll need to use a full path for both the 
  337. original file and its new name.  As an example, if you want to change 
  338. A:\TEST.DOC to A:\TEST2.DOC, you'll need to specify A:\TEST2.DOC as the new 
  339. name.  You can't leave out the drive specifier, and you need to specify any 
  340. subdirectories A:\TEST.DOC might be in as well.
  341.  
  342.  
  343.                                 DELETING FILES
  344.  
  345. This is fairly simple, and rather dangerous.  You're warned about the 
  346. possibility of losing files, and the impossibility of restoring them, and then 
  347. given the opportunity to quit.  If you decline this invitation, you're asked 
  348. which file you want obliterated.  You'll input the file you want decimated, 
  349. including the drive and path.  You are then warned again  (annoying, ain't 
  350. I?), and once again given the opportunity to get out of harm's way.  Pressing 
  351. any key except Esc will destroy the irreplaceable data in your chosen file.  
  352. You are next informed that the foregoing has occurred, and invited to make the 
  353. same mistake with a different file.  You really should make backups, you know.
  354.  
  355. Note:  There are public domain and commercial "undelete" utilities that I'm 
  356. aware of.  If you have one of these, or MS-DOS 5.0, you can probably undelete 
  357. any file you've killed from The Manager.  However, you'll need to use the 
  358. undelete utility immediately; if The Manager (or any other program) writes to 
  359. the section of the disk where your deleted file is, you won't be able to 
  360. recover it.
  361.  
  362.  
  363.                             RUNNING OTHER PROGRAMS
  364.  
  365. With this feature, you first type in the name of the program you want to run, 
  366. 7
  367. including the drive and path.  For instance, if you want to run LIST.COM, 
  368. which is on drive C: in the UTILITY directory, you would type
  369.  
  370.                               C:\UTILITY\LIST.COM
  371.  
  372. at the prompt.  You'll then be prompted for a parameter, which in this case 
  373. will be the name of a file you want to view.  When finished, you'll be asked 
  374. to press a key.  This is so you can still see the last screen of whatever the 
  375. program was doing.  Once you press a key, the screen will clear, and you'll be 
  376. offered the chance to run another program.  If you accept, you'll get to do 
  377. the same thing over again; otherwise, you'll be sent back to the main menu.
  378.  
  379. Apparently, three of my command-line parameters (/l, /L, and /40) get sent 
  380. along with the CALL command.  I can't for the life of me figure out why but, 
  381. as a result, programs like CHKDSK just won't run.  I've got some ideas for an 
  382. error routine that might fix that, but it might not either and it'll be a 
  383. little while before I get to it.  Until then, we'll all have to be frustrated.  
  384. I send copies of this disk to Mr. Visti each time I upgrade my registration 
  385. for ASIC, so when version 4.0 comes out he'll have an opportunity to find out 
  386. about this.  From the replies I've gotten, he does check the disk out for the 
  387. purpose of finding potential bugs in the compiler or unclear areas in his 
  388. documentation.  So, if it's a problem with the compiler, it'll likely be fixed 
  389. in the future. 
  390.  
  391. The "Run Other Programs" option has been put together with the "Shell to DOS" 
  392. option.  As a result, when you call the "Run Other Programs" routine, you'll 
  393. see your COMMAND.COM (along with the path as set by DOS if any) on the line.  
  394. If you just want to go to DOS temporarily, press Enter.  If not, just type the 
  395. name of the program (along with the drive and path, of course).  The line that 
  396. was there will disappear, and be replaced by what you're typing.
  397.  
  398.  
  399.                             WORKING WITH CONFIG.SYS
  400.  
  401. This guy allows you to view, change, and add lines to your CONFIG.SYS file.  
  402. Because you can specify any drive (from A: through E:) for your CONFIG.SYS, 
  403. you can use test files to make sure you've got it the way you want it before 
  404. you commit yourself.  However, if you do decide to make a real file the first 
  405. time out, your original CONFIG.SYS will be saved as CONFIG.BAK, so you can get 
  406. it back by deleting the new CONFIG.SYS and renaming CONFIG.BAK to CONFIG.SYS 
  407. again.  That only works if you're making a brand-new file, though; if you're 
  408. adding lines, they'll be appended directly to the file you specify, in the 
  409. root directory and no backup will be made.  As a result, you might want to 
  410. consider using a test file to make sure everything runs OK before you commit 
  411. your system.
  412.  
  413. First, you'll be asked what drive your CONFIG.SYS is on.  This is where, 
  414. if you're not sure you want to mess with your real file, you can specify a 
  415. different drive.
  416.  
  417. Next, you'll see a small menu, which allows you to just view your CONFIG.SYS, 
  418. add lines to the end of the file, create a whole new file, or return to the 
  419. Main Options Menu.  You'll press the key corresponding to your choice, and be 
  420. sent to the appropriate option.
  421.  
  422. If you elect to just view your file, it'll be displayed on the screen.  You 
  423. can look at it as long as you want.  When you're ready to go back to the menu, 
  424. press a key.
  425.  
  426. If you want to add lines to the end of your CONFIG.SYS, the screen will clear 
  427. 8
  428. and you'll be asked to type the line you want to add.  When you're done, or if 
  429. you change your mind before typing anything, press Q and then press Enter.  
  430. Upper or lower case makes no difference.  Eventually, I'll be standardizing 
  431. the CONFIG.SYS section so you can press Esc at any point in order to quit, but 
  432. I haven't quite gotten to it yet.  So, if it says to press Esc to quit, do 
  433. that.  It should be designed so you can press Esc at any point in the process 
  434. to quit, but I can't guarantee that yet, since I haven't started working on it 
  435. at this point.  ANYway, once you've quit, you'll see your new CONFIG.SYS 
  436. (unless you quit without adding lines, in which case you'll see your old 
  437. CONFIG.SYS).  You'll press a key to go back to the CONFIG.SYS menu.
  438.  
  439.                         CREATING A NEW CONFIG.SYS FILE
  440.  
  441. This part is a bit more complicated, so it's got its own section.  The first 
  442. thing that'll happen is that your CONFIG.SYS will be renamed CONFIG.BAK to 
  443. save it, and you'll be notified that the foregoing has occurred.
  444.  
  445. Next, you'll be asked how many files you want.  If you don't know what that 
  446. means, this is an excellent time to quit, since your original CONFIG.SYS will 
  447. immediately be restored and you'll be returned to the CONFIG menu.  Otherwise, 
  448. type in the number of the files you want.
  449.  
  450. Now you get to type in how many buffers you want.  Type in a number; you can't 
  451. quit at this particular point.  You'll still be able to abort later on if you 
  452. want, so don't worry too much about it.
  453.  
  454. After you've typed in your buffers, you'll be asked if you want to include a 
  455. device driver.  You'll get to see a list of the drivers available, but only if 
  456. they're in the root directory of the disk you specified.  Later along, I plan 
  457. to include an option that lets you specify where your drivers are, but I 
  458. haven't gotten to it yet.  If you don't want to include any drivers, type N 
  459. (either upper or lower case, makes no difference) and Enter.  Otherwise, type 
  460. in the name of the device.  If the device isn't in the root directory, you 
  461. should include the full path.  You'll be asked if you want to include more 
  462. devices, and be sent back to the area where you type in the device name, until 
  463. you type N in response to that question. 
  464.  
  465. When you're finished with that, you'll be asked if you want BREAK on or off.  
  466. If you turn it on, it'll be easier to quit a utility or DOS function, because 
  467. DOS will check to see if Ctrl-C has been pressed more often.  It'll take a bit 
  468. more memory, though, and slow things down a trifle.  Nothing's free.
  469.  
  470. Finally, you'll see your finished product and get a chance to redo the whole 
  471. thing, give it up and restore your original CONFIG.SYS, or accept it.
  472.  
  473.  
  474.                            WORKING WITH AUTOEXEC.BAT
  475.  
  476. This is essentially identical to the option for working with the CONFIG.SYS 
  477. file, and is self-explanatory in my opinion.  If you have a different opinion, 
  478. let me know and I'll try to help if I can.  If it looks like some portion of 
  479. the option is unclear, I'll try to clarify in this section of the 
  480. documentation. 
  481.  
  482.  
  483.                               MAKING A DIRECTORY
  484.  
  485. Again, fairly simple.  This time, completely harmless.  The only limitation is 
  486. that each directory used takes up some disk space.  It is theoretically 
  487. possible to create so many directories you don't have room for any files.
  488.  
  489. 9
  490. You'll tell The Manager the directory you want created, including drive and 
  491. path.  You'll then be informed that the directory you wanted has been 
  492. delivered, and be given the opportunity to make another. 
  493.  
  494.  
  495.                              REMOVING A DIRECTORY
  496.  
  497. This section isn't very good right now.  To use it, you need to know whether 
  498. or not the directory you want to remove contains subdirectories, and whether 
  499. or not there are files in the directory or subdirectories.  In my opinion, 
  500. there's simply too much work involved from The Manager, but I'm working on 
  501. improving things.  For now, unless you enjoy a challenge, I recommend using 
  502. DOS for this job.
  503.  
  504.  
  505.                         CHANGING THE DEFAULT DIRECTORY
  506.  
  507. If you're not running The Manager from a hard drive, you shouldn't have any 
  508. need for this option.  If you use it, you'll run into another problem; the 
  509. files The Manager looks for won't be in the directory you changed to, most 
  510. likely.  This means that, once you've changed the directory, you won't be able 
  511. to use any options that aren't loaded into memory, which includes the Change 
  512. Directory option.  I'll be working on a routine to temporarily change the PATH 
  513. to include the directory The Manager's files are on in the future.  For now, 
  514. if you get stuck you'll need to shell to DOS using the "Run Other Programs" 
  515. option, and change the directory back to the one The Manager and its files are 
  516. on; then EXIT and run the options you want.  Sorry about that, but it should 
  517. be fixed in a future version.
  518.  
  519.  
  520.                          CHECKING FOR A GRAPHICS CARD
  521.  
  522. Does exactly what it says.  Checks for a graphics card, and tells you one way 
  523. or the other.  I don't know if it will recognize MGA (A.K.A. Hercules), but I 
  524. kind of doubt it.  If I get a chance to test it, I'll let you know.
  525.  
  526.  
  527.                              BLANKING YOUR SCREEN
  528.  
  529. If you press the key for this feature, your screen will go dark.  This will 
  530. help save your screen from burning "holes" (places where nothing can be 
  531. printed) on your monitor.  To return to the Options Menu, press any key.
  532.  
  533.  
  534.                           CHANGING TO 40-COLUMN MODE
  535.  
  536. I designed this feature to make it possible for the visually impaired to use 
  537. The Manager.  I assume the larger text makes it easier to read, but I don't 
  538. really know.  If you're visually impaired, and have suggestions on how to make 
  539. the screen writes more legible, I'd appreciate hearing from you.  I'm pretty 
  540. sure you need a graphics card to access this wider print mode.  I'll check 
  541. that out as soon as I can, but it may not be for a long time. 
  542.  
  543. There are certain options you can use from the 80-column mode that you can't 
  544. use from 40-columns.  For instance, since you need a graphics adapter (I 
  545. think) in order to get 40-column width, I figured it was silly to offer the 
  546. option that checks for a graphics adapter.  The file-reading option won't work 
  547. properly, since the file won't print properly on the screen.  Vern Buerg's 
  548. LIST.COM can deal with 40-column mode, because it reads the file into memory 
  549. where you can use the arrow keys to scroll sideways.  Unfortunately, I don't 
  550. 10
  551. have the skill to write a program that can do the same.  It's a goal of mine 
  552. to be able to do precisely that, but I think it'll be quite a while before I 
  553. figure out how to do it.  As soon as I do, though, I'll include it.  Anyway, 
  554. if you don't see an option in 40-column mode, it's probably because I couldn't 
  555. figure out how to write it so it would run properly, or because it wouldn't 
  556. make sense to offer it in the first place.  I'm the only one who can do much 
  557. about the former, but the latter is always open to discussion.  I don't 
  558. guarantee you'll convert me, but it won't do me any harm to listen to your 
  559. opinions.  So, opine to your heart's content, at the address on the first 
  560. page.
  561.  
  562.  
  563.                                   PARAMETERS
  564.  
  565. Using parameters from the DOS prompt can save you time, bypassing the intro 
  566. screens, taking you directly to the module where the work you want to do 
  567. resides and, for simple jobs, doing that bit of work automatically.  You can 
  568. see a list from the menu, which looks remarkably similar to the one listed 
  569. following.  Here's the list of the parameters you can currently use.
  570.  
  571. Typing MANAGER /? will let you view screens which contain this same 
  572. information.  The command for 40-column mode is MANAGER /40 ?
  573.  
  574. Typing MANAGER /S will supposedly let you see a list of disk files.  To list 
  575. files with the wide text option, type MANAGER /40 S.
  576.  
  577. Typing MANAGER /D lets you delete files.  Make backups.  The 40-column 
  578. version is MANAGER /40 D.
  579.  
  580. Typing MANAGER /M moves you to the directory-making module.  In 40-columns, 
  581. MANAGER /40 M.
  582.  
  583. Typing MANAGER /N moves you to the module for renaming files.  Make backups.  
  584. 40-column users, type MANAGER /40 N.
  585.  
  586. Typing MANAGER /G lets you view the time and/or date.  MANAGER /40 G in 40-
  587. column mode.
  588.  
  589. Typing MANAGER /B lets you blank your screen.  MANAGER /40 B in 40-column 
  590. width.
  591.  
  592. Typing MANAGER /P lets you check for a graphics adapter.
  593.  
  594. Typing MANAGER /V will let you use the file-reading feature.
  595.  
  596. Typing MANAGER /L calls the file-printing routine.  For 40-column users, the 
  597. command is MANAGER /40 L.
  598.  
  599. Typing MANAGER /40 will put you in 40-column mode, provided you have a 
  600. graphics adapter, and give you the 40-column menu.
  601.  
  602.  
  603. In each case, either upper- or lower-case should be fine.  If it isn't, I 
  604. goofed, and I'd appreciate it if you'd let me know so I can ungoof.  Thanks.
  605.  
  606.  
  607.                       THE CRAPULATOR (CRAPPY CALCULATOR)
  608.  
  609. Boy, does this one need work.  You can add or subtract two numbers at a time.  
  610. Once you've done that, the memory is cleared and you get to start again.  You 
  611. 11
  612. also get to turn NumLock on yourself, if you want to use the numeric keypad.  
  613. I have some ideas for improving this option, which I'll get to relatively 
  614. soon.
  615.  
  616.  
  617.                              GETTING THE DATE/TIME
  618.  
  619. Here you get the option of choosing to get just the date, just the time, or 
  620. both.  First you choose to Get Time/Date from the Main Menu, and then choose 
  621. which combination from another menu.  As you may have noticed, I like menus.  
  622. If the time and/or date on your computer haven't been set properly, you won't 
  623. get an accurate reading.  Assuming, however, that everything's the way it 
  624. ought to be, you should get what you're looking for (or a reasonable facsimile 
  625. thereof).
  626.  
  627.  
  628.                            SEE A LIST OF ASCII CODES
  629.  
  630. This one may be useful for programmers; it lets you know the ASCII code for 
  631. each symbol you can print on your screen.  You can also choose one symbol to 
  632. print, if you think you know the number and just want to check and make sure.  
  633. Everything's in decimal, so Hex programmers will have to convert.
  634.  
  635.  
  636.                           INSTALLING A DOS PARAMETER
  637.  
  638. This option lets you install a parameter to be used every time you run The 
  639. Manager.  For instance, if you usually run The Manager to get a list of disk 
  640. files, you can specify that parameter in the INSTALL.CFG file, and you'll be 
  641. automatically sent to that option whenever you run the program without any 
  642. parameters.  If you include a DOS parameter on the command line, these will 
  643. have priority over the "installed" one.
  644.  
  645. Most of the available parameters are included, and are selectable from a 
  646. simple menu.
  647.  
  648.  
  649.                                VIEWING YOUR PATH
  650.  
  651.  
  652. If you choose this option, you'll just get to view your current DOS path.  You 
  653. can't change it yet, because I haven't figured out how to do that once The 
  654. Manager has started running.  I'm working on it, though.
  655.  
  656.  
  657.                              WRITE-PROTECTED DISKS
  658.  
  659. If you try to delete files, make directories, or rename files on a disk that's 
  660. write-protected, DOS will interrupt The Manager with a Write-Protect Error.  
  661. You are given the usual opportunities to Abort, Retry, Ignore.  If you wish, 
  662. you can remove the write-protect tape or move the write-protect tab (depending 
  663. on your type of disk), or put an unprotected disk in that drive, and try 
  664. again.  If you choose Abort, you'll be returned to DOS.  As far as I know, I 
  665. have no control over that.  If I figure a way to get out of leaving the 
  666. program in case of an Abort, I'll write it into The Manager.
  667.  
  668. Please bear in mind, should you get that type of error, that a disk is usually 
  669. write-protected (whether by you or someone else) for good reason.  I would 
  670. advise you to think twice about unprotecting the disk.  Since there are no 
  671. restrictions on reading from a protected disk, you might want to consider 
  672. 12
  673. making a copy of that disk, and doing what you want on the copy.  That way you 
  674. get to manipulate the files to your heart's content, without damaging the 
  675. protected disk.
  676.  
  677.  
  678.                                 ERROR ROUTINES
  679.  
  680. There are a number of error routines in The Manager in case you should attempt 
  681. to do something either the program or DOS can't do.  I've designed these so 
  682. that, should you start typing in a correction and then decide to quit, you can 
  683. press Esc at any time.  It was a little on the tricky side for me to code; I 
  684. spent a long time testing, but I may not have caught all the bugs.  As always, 
  685. let me know if I missed anything. 
  686.  
  687.  
  688.  
  689.                                  IN CONCLUSION
  690.  
  691. ASIC is still being modified, and I expect more features to be available to 
  692. such cement-headed programmers as myself.  When this occurs, MANAGER.COM will 
  693. undoubtedly flesh out a bit.  You shouldn't think of this program as 
  694. representative of ASIC's capabilities; I've written a number of utilities, for 
  695. instance, which saved me the price of the registration many times over.  In 
  696. addition, I'm still a novice programmer, though I expect to graduate to 
  697. beginner some time soon.  More experienced programmers will find the 
  698. facilities (BLOAD, PEEK, POKE, etc.) to really make your programs sit up and 
  699. take notice.  I don't know how to use any of the advanced commands, so don't 
  700. judge the compiler by the programs I've written. 
  701.  
  702. Your comments, questions, and criticisms would be greatly appreciated, 
  703. including correcting my grammar, spelling, etc.  My goal is to write quality 
  704. software, and I need your help to do it.  Thanks.
  705.  
  706.  
  707.                                      TESTS
  708.  
  709. Version numbers exist for the purpose of testing this disk's utilities on 
  710. other computers.  Version 1.00 has been tested on the following:
  711.  
  712. Amstrad PC1512 SD: This system has an 8086 CPU, a composite monochrome 
  713. monitor, and CGA which can access 16 shades of gray (or color with a color 
  714. monitor) with a resolution of up to 640 X 200.  The system originally came 
  715. with 512K RAM, which I've upgraded to 640K.  I've also added a 2 Mb EMS card.  
  716. It came with a single 5.25", 360K drive.  A second internal drive of the same 
  717. type was later added, and I've installed a 49Mb hard disk card.  Operating 
  718. system is MS-DOS 5.00.  This line has been discontinued.  The Manager had no 
  719. problems running on the Amstrad. 
  720.  
  721.  
  722. Packard Bell Pack-Mate: This system has an 80286 CPU and a color VGA monitor.  
  723. There's 640K RAM, and 384K Extended Memory.  Drives are one 40Mb internal hard 
  724. disk, one 5.25", 1.2Mb drive, and one 3.5", 1.44 Mb drive.  Operating system 
  725. is MS-DOS 3.30.  FILE-MAN 1.00 had no problems running on the Packard Bell. 
  726.  
  727. Version 2.XX has not been tested on any systems other than the Amstrad, where 
  728. it showed no problems.
  729.